API 更新日志

2025-10-30

1. 修复支付渠道 extra 参数说明渠道名称

2025-07-09

1. 更新元数据 metadata 键值对限制为 20

2025-04-29

1. 更新 charge 支付渠道 extra 参数说明,upacp/upacp_wap/upacp_pc 新增 risk_info 风控信息域参数;
   
2. 新增易宝银行转账支付
   
3. 更新易宝快捷支付参数说明
   
4. 撤销 charge 移除 alipay 支持.

2025-04-07

1. 更新创建 transfer 接口 ：微信商家转账产品参数说明
   
2. 新增撤销 transfer 接口
   
3. 更新 transfer 概述 status 枚举值说明

2025-03-13

1. 添加支付渠道 extra 参数中返回的支付请求渠道商户号说明
   

2025-03-11

1. 添加易宝个人网银/企业网银支付文档
   

2025-02-27

1. 下线京东代付
   

2022-11-29

1. 新增 Webhooks 事件 ：charge.failed 、refund.failed
   
2. 新增 易宝支付 extra 参数
   
3. 新增 易宝支付 支付渠道属性值
   

2021-11-17

1. 更新 撤销 Charge 对象 接口

2021-08-17

1. 创建 Charge 对象 client_ip 字段 新增描述
2. 创建 Transfer 对象 微信企业付款 新增 wx_bank_code 字段，原 open_bank_code 保留不变
3. 微信H5支付 extra 参数 result_url 新增描述

2021-06-11

1. 取消/更新 Order 对象接口中 status修改为选填

2021-06-02

1. 修改创建 Charge 对象中 time_expire 字段：微信对该参数的有效值为 2 小时内

2021-1-23

1. alipay 支付宝企业付款 extra 参数新增 order_title 字段

2020-12-28

1. 支付宝 APP 支付和支付宝电脑网站支付 extra 参数新增 is_absolute_time 字段
2. 修改创建 Transfer 接口和创建 Withdrawal 接口中支付宝企业付款 extra 参数的 recipient_account_type 字段描述。

2020-10-21

1. 畅捷代付渠道
2. order 订单的过期时间最小值修改为 1 分钟

2020-5-11

1. 银联手机控件支付新增 discount_code 字段

2020-4-26

1. 新增 order 更新接口
2. 支付 order 接口过期时间描述更新
3. 删除辅助接口：银行支行信息查询接口

2019-12-17

1. 更新通联支付行号
2. 删除子商户应用渠道参数说明中的微信相关渠道的退款操作员 ID
3. 余额明细交易类型更新

2019-06-13

1. 新增畅捷扫码支付渠道
2. 新增 cb_wx_pub & cb_wx_pub_qr 渠道针对香港地区的 goods_list 字段说明
3. 新增辅助接口：银行支行信息查询接口
4. 更新通联代付银行编号

2019-05-30

1. 新增线下小程序 isv_lite 支付渠道。
2. 新增下单接口 client_ip 字段支持 IPv6 格式。
3. 新增支付宝跨境必传字段 refer_url、trade_information 。

2019-04-18

1. 新增微信支持上传「电子发票入口开放标识」字段。
2. 新增分期渠道：库分期。
3. 新增企业付款渠道：畅捷代付。

2019-03-28

1. 新增用户接口支持 parent_user_id 参数。
2. 新增渠道：移动和包支付。

2019-02-28

1. 新增会员账户系统支持跨境渠道。
2. 更新一网通渠道 p_no、seq、m_uid、mobile 为可选。

2019-01-23

1. 新增报关接口对于属地和总署报关描述说明。
2. scan 类渠道 scan_code 描述优化。

3. 子商户渠道参数配置：

   1. 微信企业付款新增「企业付款到银行卡费率 bank_fee_rate」
   2. 微信支付渠道新增「微信新资金流 finance_version」
   3. 微信类渠道删除「app_secret」字段
   4. 支付宝针对 openapi 版本「alipay_account」参数可选
   5. 银联渠道新增「贷记卡费率 credit_fee_rate」与「最低手续费 min_fee」
   6. 京东支付新增「白条手续费字段 baitiao_fee_rate」
   7. 新增招行 PC 扫码渠道参数配置

2018-12-27

1. 更新身份认证接口 result_code 说明。

2018-12-19

1. 新增银联扫码支付渠道子商户参数配置。
2. 更新微信类渠道名称与微信官网同步。

2018-11-28

1. 新增支付宝小程序支付渠道。

2018-11-13

1. 移除线下扫码渠道关于中信银行的相关说明。
2. 新增建行 APP 支付及扫码支付渠道。

2018-10-31

1. 文档结构调整及性能优化。
2. 新增注释性说明：服务端在传 Charge / Order / Recharge 对象到客户端前，请先使用各 SDK 自带的序列化方式（比如 Java 的 .toString()）将对象转换成 JSON 字符串。
3. 新增银联二维码支付（主扫和被扫）渠道 upacp_qr & upacp_scan。
4. 新增跨境支付宝扫码和刷卡渠道 cb_alipay_qr & cb_alipay_scan。

2018-09-10

1. 新增各退款接口 description 字段，针对 jdpay_wap 渠道的说明：最大长度为 128 字节。

2018-08-15

1. 更新报关接口支持的渠道列表。
2. 新增 cmb_wallet & cmb_pc_qr 渠道针对退款的 description 字段长度限制为：最大支持 99 字节。
3. 新增 cmb_pc_qr 渠道 extra 返回参数 card_type 说明。

2018-08-01

1. 新增红包接口 scene_id 描述：红包金额大于 200 或者小于 1 元时必传。
2. 新增 cmb_pc_qr 招行 PC 扫码支付渠道。
3. 新增 jdpay_wap 渠道支持白条前置功能。

2018-06-28

1. 新增 upacp_b2b 企业网银渠道。
2. 新增跨境支付宝（App、手机网站、电脑网站）支付、跨境微信（App、公众号、扫码、刷卡）支付以及 PayPal 支付。
3. 新增招行一网通渠道调起招商银行 App 支付方式。

2018-05-31

1. 更新报关接口相关说明。

2018-05-17

1. 新增 webhooks 异常处理功能相关介绍。
2. 新增优惠券模板折扣上限字段 discount_amount_limit 。
3. 更新 Withdrawal 提现接口 description 字段为必填。

2018-05-03

1. 更改 jdpay_wap 渠道 user_id 为必填。
2. 新增子商户渠道参数 refund_return_fee 参数。

2018-03-29

1. 新增微信企业付款支持 wx 渠道。
2. 新增用户结算账户增加支持通联 B2B。

2018-03-15

1. 新增通联代付对于 B2B 场景相关字段。
2. 新增微信企业付款到银行卡功能。
3. 新增提现支持自定义渠道。
4. 新增分润支持多个订单号查询和结算。
5. 新增批量企业付款失败 batch_transfer.failed 事件。
6. 新增微信优惠券相关返回字段。

2018-03-01

1. 新增 wx_wap 渠道 extra 参数 limit_pay。
2. 新增订单支持余额结算。

2018-01-25

1. 更新查询 Order 对象列表接口 per_page 参数最大值为 20。
2. 新增 Order 订单支持组合支付。
3. 移除 Order 对象相关返回字段。

2018-01-11

1. 新增 QQ 钱包退款资金来源 funding_source 字段。
2. 移除创建结算账户对象 bank_account 渠道相关参数。

2017-12-28

1. 更新 alipay_pc_direct 渠道 extra 参数 success_url 为选传。
2. 更新 time_expire 针对微信渠道订单有效期说明。
3. 移除 Transfer 接口针对银联电子代付渠道的 5 分钟取消功能。
4. 新增提现申请支持对公账户。

2017-12-14

1. 更新线下扫码 isv_wap 渠道 extra 参数。
2. 新增 alipay_pc_direct 渠道 extra 参数 qr_pay_mode、qrcode_width。

2017-12-01

1. 更新银联及 Apple Pay 渠道支付 extra 返回参数说明。
2. 新增用户结算账户对微信小程序及贵州银联代付渠道的说明。

2017-11-23

1. 更新报关接口海关编号说明。
2. 更新 Batch Refunds 批量退款接口注意事项。
3. 新增优惠券模板单个用户优惠券最大生成数量 max_user_circulation 字段。
4. 新增订单退款 order.refunded 事件。
5. 新增分润结算明细对象关联企业付款对象 transfer 字段。
6. 新增分润结算失败时的错误消息描述 failure_msg 字段。

2017-11-01

1. 更新 balance 支付渠道 extra 参数说明。
2. 更新 Order 订单有效期延长至 7 天。
3. 新增 Order 订单自定义支付渠道 custom。
4. 新增支付 Order 接口 time_expire 字段。
5. 新增针对微信服务商模式下商户的提示信息。
6. 新增会员系统代付渠道 wx_lite / unionpay_gz 相关文档。

2017-10-18

1. 更新余额充值接口支持自定义渠道给系统用户充值。
2. 新增 QQ 钱包公众号支付。
3. 新增分润结算对象与对应订单列表关联参数。
4. 新增批量企业付款贵州银联代付渠道。
5. 新增支付宝当面付渠道口碑支付。

2017-09-20

1. 新增 Webhooks Event 事件 transfer.failed 示例。
2. 新增微信公众号刷卡支付及支付宝条码支付。
3. 新增企业付款 jdpay allinpay 渠道支持打款至信用卡功能。
4. 新增企业付款贵州银联代付及微信小程序渠道。
5. 新增批量企业付款微信小程序渠道。
6. 新增子商户应用支付渠道参数对于企业付款的相关说明。
7. 新增撤销 Charge 接口。

2017-09-04

1. 更新 Balance Transaction 对象 source 字段描述。
2. 新增 Webhooks Event 事件类型示例。

2017-08-30

1. 更新招行接口（1.0 和 2.0）商户订单号限制规则。
2. 更新 subject、body 字段对于支付宝部分渠道的说明。
3. 更新认证接口 result_code 说明。
4. 新增 Webhooks 事件类型。

2017-07-26

1. 更新 Refund 退款中 funding_source 字段的描述。
2. 更新企业付款 alipay 渠道 extra 字段 recipient_name 参数描述。
3. 更新批量企业付款 alipay 渠道 recipients 字段 name 参数描述。
4. 新增银联网关支付 upacp_pc 渠道 extra 参数 iss_ins_code（发卡机构代码）。

2017-07-12

1. 新增红包状态 refunding：退款中。
2. 新增报关接口针对 C#、Java、Ruby、Python 的示例。
3. 新增身份证银行卡信息认证接口针对 Phyhon、C# 的示例。
4. 新增支付宝电脑网站渠道 2.0 接口参数说明。

2017-06-28

1. 分页 list API 方法中 limit 参数限制范围更新为 1~100。
2. alipay、alipay_wap 渠道 extern_token 字段添加说明：仅适用于支付宝 1.0 接口。
3. 更新支付宝各个渠道的 order_no 描述。
4. 新增大数据产品支付数据字段说明。

2017-06-15

1. 『企业付款（银行卡）』渠道名称更新为『银联电子代付』。
2. Charge 支付中 time_settle 属性：『仅针对个人开发者』更新为『暂不生效』。
3. jdpay_wap 渠道中添加 extra 字段 pay_list。
4. 新增 Transfers 企业付款渠道：京东代付和通联代付。
5. 新增 Batch Transfers 批量企业付款针对 C# SDK 的示例。
6. 认证中的 C# 语言示例 Pingpp.Key 改为 Pingpp.Pingpp.SetApiKey。
7. Webhooks 重发次数及通知时间间隔更正。

2017-04-26

1. 新增支付宝 Charges 支付对应支付宝 2.0 接口的花呗分期支付方式、禁用信用卡等新功能；新增对应 extra 返回参数。
2. 调整部分文档格式。

2017-04-19

1. 新增支付宝渠道的 Transfers 企业付款。
2. 新增支付宝、微信渠道的 Batch Transfers 批量企业付款。
3. 补充红包接口，测试模式下需要主动调用查询接口才能出发 Webhooks 回调。

2017-04-05

1. 补充 Transfers 企业付款付款金额 amount 字段说明。
2. 补充 API 接口错误码和对应报错信息。
3. 新增元数据 Metadata 可选字段。

2017-02-15

1. 新增 customs.succeeded 和 batch_refund.succeeded 两个 Event 事件类型和对应 Event 回调对象示例。
2. 修改支付宝即时到账渠道名为支付宝电脑网站支付。
3. 修改报关接口说明，添加请求接口说明文档中对 applepay_upacp 渠道的支持。

2017-02-08

1. 修改 Transfers 企业付款 description 参数说明，查询 Trasnfer 对象列表 limit 参数说明。
2. 修改 Events 事件类型 summary 类型事件触发时间。
3. 新增 辅助接口、Transfer 对应 unionpay 渠道 API 验签方式说明。

2017-01-12

1. 修改报关接口说明文档，去掉不支持拆单的文字描述，新增 trade_no 字段说明。
2. 新增银联全渠道返回参数 pay_type、acc_no、pay_card_type。
3. 新增创建 Red Envelope 对象的 extra 参数 scene_id，详情请参考API文档。
4. 新增微信小程序支付渠道 wx_lite ，并添加渠道 extra 参数。
5. 新增 jdpay_wap 京东手机网页支付渠道的 extra 参数，添加可选参数 user_type、user_id。

2016-12-28

1. 修改请求报关接口 curl 示例，添加请求内容中的 apikey ，添加对应 php、go、python示例文档。
2. 添加批量企业付款接口对应 php、go、java 示例文档。
3. 添加批量退款接口对应 php、go 示例文档。
4. 添加身份认证接口对应 go 示例文档。
5. 修改退款接口对应 java 示例文档。
6. 修改批量退款接口 per_page 默认值为 10。
7. 修改批量企业付款请求接口 per_page 默认值为 10。
8. 添加支付、批量退款、红包、企业付款、批量企业付款对应查询列表对象接口文档示例，新增请求示例中的 expand[]=app。
9. 修正红包请求接口中 metadata 字段为可选。
10. 修正支付宝电脑网站支付渠道对应 extra 参数，添加返回参数 buyer_account。
11. 调整文档格式，标题栏所有对象名首字母大写。

2016-11-30

1. 新增批量企业付款到银行卡接口。
2. 新增批量退款查询列表接口请求示例部分的验签示例。
3. 下线 Event 对象列表查询接口。

2016-11-23

1. 下线应用内快捷支付相关说明文档和示例。

2016-11-16

1. 新增 metadata 可选字段 phone_number。
2. 更新 Node.js SDK 批量企业付款接口。
3. 修改 API 更新日志中批量企业付款链接部分错误。

2016-11-09

1. 调整标题"回调"为"Webhooks 回调"，新增相关 Webhooks 通知说明。
2. 修改报关接口部分参数问题。
3. 新增批量企业付款单次请求的企业付款订单数量限制。

2016-11-02

1. 修改文档中"批量付款"为"批量企业付款"。
2. 调整文档中交易部分的目录结构顺序。
3. 修改批量退款 和 批量企业付款部分文档示例，修改batch_no字段说明，允许字母和英文。
4. 修改支付渠道属性值，补充各渠道支付场景。
5. 新增更新 Transfer 接口 Node.js SDK 请求示例。

2016-10-19

1. 新增 QQ 钱包渠道说明文档。
2. 新增 微信渠道退款字段 funding_source。
3. 修改 Batch Transfers 批量企业付款接口说明，去掉 transaction_no 字段，修改部分示例代码。
4. 修改 企业付款（银行卡）渠道 order_no 字段说明，只支持 1～16 位纯数字。

2016-10-10

1. 新增身份认证 Java SDK请求示例。
2. 新增 Batch Transfers 批量企业付款接口。
3. 修改 Batch Refunds 批量退款接口查询列表强制验签说明。
4. 新增 batch_transfer.succeeded 批量企业付款 event 事件和事例说明。

2016-09-20

1. 招行一网通渠道修改 extra 参数说明备注。
2. 新增 applepay_upacp 渠道报关文档说明。
3. 修改企业付款和红包接口的文档，不再支持 wx 渠道的企业付款和红包。

2016-09-07

1. 新增银联报关接口，修改原支付宝，微信报关接口参数。
2. 新增招行一网通渠道返回参数，extra 中新增优惠金额参数 discount_amount。

2016-08-24

1. 新增支付宝批量退款接口。

2016-08-17

1. 更新企业付款（银行卡）渠道参数：新增extra字段 open_bank_code 参数，修改 open_bank，prov，city 参数为optional，新增该渠道接口调用注意点。
2. 新增企业付款（银行卡）银行编号附录。
3. 修改 wx_wap 渠道extra字段：去掉 limit_pay 参数，新增 result_url 参数。

2016-08-10

1. 添加 charge 对象 time_paid 说明：银联支付成功时间为接收异步通知的时间。

2016-08-03

1. 新增 alipay_wap 渠道extra字段 app_pay 参数，用于判断是否使用支付宝客户端支付；修改 cancel_url 参数说明，当 app_pay 为true时，cancel_url 字段无效。
2. 修改招行一网通extra字段参数说明，p_no, seq, m_uid, mobile 这几个参数决定是否签约，传同样的参数，就不会重新签约。
3. 新增 jdpay_wap 渠道extra字段 order_type 和 is_mobile 参数。

2016-07-27

1. 身份证银行卡信息认证接口更新phone_number参数，添加说明：暂不支持178开头的手机号。
2. 身份证银行卡信息认证接口添加php，ruby对应SDK请求示例和返回示例。

2016-07-20

1. 新增 更新 Transfer 对象接口。
2. 修改 Customer 对象，Card 对象请求参数：添加sms_code[id] 和 sms_code[code] 参数,修改 Customer 对象 和 Card 对象请求示例。

2016-07-13

1. 新增支付渠道： 微信WAP支付 wx_wap ，接入规则请参考 API 文档；使用该渠道，需更新客户端 SDK。
2. 修改 身份证银行卡信息认证接口参数：app_id 改成 app、idcard 改成 id_card、bankcard 改成 bank_card、user_name 改成 id_name。
3. 修改 报关接口参数：app_id 改成 app。

2016-07-06

1. 新增 报关接口。
2. 新增 企业付款（银行卡）接口。

2016-06-30

1. 新增支付渠道： 招行一网通 cmb_wallet。
2. 新增 身份证银行卡信息认证接口。

2016-06-22

退款 Refund 对象中增加商户订单号 charge_order_no 字段，请求退款之后会在返回的 Refund 中带回付款订单的商户订单号。

2016-06-16

升级支付宝手机网站（alipay_wap）支付接口，针对已经接入旧接口的用户请在 3 个月内更新成新接口。旧接口的用户更新只需要三步：

• 更新客户端 H5 SDK；
• 在服务端请求中增加额外的请求字段 new_version ，详细步骤请参照 alipay_wap 接口更新说明；
• 更新 Ping++ 管理平台上的支付宝手机网站支付的渠道参数，更新成支付宝的 合作伙伴密钥 对应的参数，详情请参考帮助中心；
• 更新到新接口之后，alipay_wap渠道的同步返回参数也会有相应的变更，具体内容请参考 帮助中心。

2016-05-18

红包接口和微信官方接口同步：下线 extra 参数中的 nick_name、logo、share_url、share_content 和 share_img 字段。兼容旧接口，已接入用户可忽略该变更。

2016-04-27

1. API－微信类接口增加 goods_tag 字段。
2. API－支付宝电脑网站支付可选参数 anti_phishing_key 变更为 enable_anti_phishing_key，为布尔值。
3. API－修复代理商 App 创建微信企业付款( transfer )时报错信息错误的问题；
4. API－修复红包在测试模式 transaction_no 值为 null 的问题。